home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1996 February: Tool Chest / Apple Developer CD Series Tool Chest February 1996 (Apple Computer)(1996).iso / Sample Code / SCSI Samples 1.0 / Read Me < prev   
Encoding:
Text File  |  1994-06-16  |  2.9 KB  |  69 lines  |  [TEXT/ttxt]
  1. SCSI Samples
  2. Copyright © 1994, Apple Computer Inc. All Rights Reserved.
  3.  
  4. ••• ••• •••
  5. These samples use a preliminary version of scsi.h that is
  6. close to, but not completely, final. When the final Universal
  7. Header version of scsi.h is released, you should replace
  8. references to
  9.     #include "scsi.h"
  10. with
  11.     #include <scsi.h>
  12. and may to make other small edits in all of the samples.
  13. ••• ••• •••
  14.  
  15. This is a collection of samples that illustrate programming
  16. the original (Inside Mac-IV) and asynchronous SCSI Managers.
  17.  
  18. These samples were written over a number of months to
  19. illustrate issues and solve specific developer problems. They
  20. do not provide a good illustration of Macintosh application
  21. design. In some samples, the actual human interface is minimal
  22. or non-existant, as the sample is only intended to illustrate
  23. a programming issue that would be obscured by attention
  24. to human-interface considerations.
  25.  
  26. As of this writing, SCSI Manager 4.3 is still under development,
  27. and you should expect to have to change the code slightly to
  28. track changes in <scsi.h>.
  29.  
  30. Also, while the samples have been compiled under several
  31. programming environments (MPW 3.3.2, MetroWerks DR3, and
  32. Think 7.0) there may be subtle differences between the various
  33. environments that were not discovered during testing.
  34.  
  35. As of this writing, all modules were tested under Think C
  36. 7.0 (except for the sample disk driver, which was compiled
  37. under MPW 3.3.2). They were checked using the SCSI Manager
  38. 4.3f1 extension released with System 7.5b2. They have been
  39. briefly tested using MPW 3.3.2 and MetroWerks DR3.
  40.  
  41. The following samples are provided:
  42.  
  43. • SCSI Async Sample - demonstrates fully asynchronous
  44.     physical-block I/O to a SCSI device from an application.
  45.     This can be used as the basis for a drive test utility.
  46. •  SCSI DriveID Sample - demonstrates the relationship
  47.     between volumes, drives, drivers and devices. The
  48.     subroutines may be useful to utility program writers.
  49. • SCSI Driver Example - This is a sample device driver that
  50.     supports the original and asynchronous SCSI Manager. It
  51.     should not be used for production, but may be useful in
  52.     organizing a third-party SCSI device driver.
  53. • SCSI Find Devices - This contains a subroutine that greatly
  54.     simplifies iterating over all connected SCSI devices, along
  55.     with a very small main program that illustrates its usage.
  56. •  SCSI Inquiry Samples - These are three very simple samples
  57.     that were written to illustrate bare-bones SCSI Manager
  58.     programming. They are only useful as an introduction to
  59.     the SCSI Manager(s), but are not greatly useful.
  60. •  SCSI Simple Sample - This is the core of a utility that
  61.     executes SCSI commands, and may be useful for exploring
  62.     SCSI devices. Unfortunately, it is no longer very simple.
  63. • SCSI VBL Sample - This illustrates executing a SCSI
  64.     command from a VBL.
  65.  
  66. Written by Martin Minow, MACDTS.
  67. minow@apple.com
  68. AppleLink: MINOW, DEVSUPPORT
  69. .